WAIT EVENT <label>

Description:
This command processes a mouse event and deterimines if a click has
occured in the region specified for the region label.  If the click is
not in that region, nothing happens.  If a click does occur in the
active and specified region, the program continues.  See the Technical
Reference section for more details about the button GET list array.

Syntax:
WAIT EVENT <label> [RELEASE]

Arguments:
<label> is an object name assciated with a region to prompt for.

Example:
DRAW BOX FROM 21,26 TO 22,56              // display a box
@ 21.5,28 DRAW "CLICK HERE..."            // display message in box
DEFINE EVENT "PAUSE" ;                    // define the event area
   FROM 21,26 TO 22,56 ;                  // specify the area
   ACTIVATE                               // activate the region
WAIT EVENT "PAUSE" RELEASE                // wait for a mouse press

         Purpose: Wait for a mouse click in a specific region
 Mapped Function: __WaitForClick() contained in GLLIBR.PRG.
   dGE functions: mstatus(),mgethot()
   Other GL UDFs: __ScanObjects(),__DeaEventRegion(),__RelEventRegion()
System variables: _handles_[]
System constants:

See Also:
DEFINE EVENT, ACTIVATE EVENT, DEACTIVATE EVENT, RELEASE EVENT